Skip to content

[WIP] - Add Brazilian Portuguese (pt-BR) translation#1112

Draft
Rychillie wants to merge 9 commits into
vapor:mainfrom
Rychillie:Rychillie/vapor-docs-pt-br
Draft

[WIP] - Add Brazilian Portuguese (pt-BR) translation#1112
Rychillie wants to merge 9 commits into
vapor:mainfrom
Rychillie:Rychillie/vapor-docs-pt-br

Conversation

@Rychillie

@Rychillie Rychillie commented Mar 29, 2026

Copy link
Copy Markdown

Summary

Adds complete Brazilian Portuguese (pt-BR) translation for the Vapor documentation.

What was implemented

Setup

  • Registered pt locale in mkdocs.yml with full nav_translations mapping
  • Added pt-BR entry to .github/translation_needed.description.leaf

Translated Sections

Install & Getting Startedindex.pt.md, macOS, Linux, Hello World, Folder Structure, SPM, Xcode

Basics — Routing, Controllers, Content, Client, Validation, Async, Logging, Environment, Errors

Fluent — Overview, Model, Schema, Query, Relations, Migration, Transaction, Advanced

Leaf — Overview, Getting Started, Custom Tags

Redis — Overview, Sessions

Security — Passwords, Crypto, JWT, Authentication

Advanced — APNS, Commands, Files, Middleware, Queues, Request, Server, Services, Sessions, Testing, Tracing, WebSockets

Deploy — Docker, Fly, Heroku, DigitalOcean, Nginx, Supervisor, Systemd

Contributing — Contributing Guide

Version — Legacy Docs redirect

Translation Guidelines

  • Informal tone using "você"
  • All code blocks, terminal commands, paths, and API names kept in English
  • Technical terms (middleware, handler, framework, async/await, deploy, etc.) kept in English
  • Brazilian Portuguese conventions ("arquivo" not "ficheiro")
  • Admonition titles translated ("Dica", "Nota", "Aviso")
  • Internal links unchanged (i18n plugin resolves automatically)

@Rychillie
Rychillie requested review from a team, 0xTim and gwynne as code owners March 29, 2026 22:08
@Rychillie Rychillie changed the title Add Brazilian Portuguese (pt-BR) translation: setup and initial pages [WIP] - Add Brazilian Portuguese (pt-BR) translation: setup and initial pages Mar 29, 2026
@Rychillie Rychillie changed the title [WIP] - Add Brazilian Portuguese (pt-BR) translation: setup and initial pages [WIP] - Add Brazilian Portuguese (pt-BR) translation Mar 29, 2026
@Rychillie
Rychillie marked this pull request as draft March 29, 2026 22:10
@bolodissenoura

This comment was marked as spam.

@lucianfialho

This comment was marked as spam.

@Andsu-dev

This comment was marked as spam.

@TheHandyOwl TheHandyOwl added the translation-update This PR contains translations for the docs label Apr 2, 2026
Add Portuguese language configuration to mkdocs.yml with all nav_translations,
update translation_needed issue template, and translate the first 7 pages:
index, install (macOS/Linux), and getting-started (hello-world, folder-structure,
spm, xcode).
…nt, client, validation, async, logging, environment, errors)
…ery, relations, migration, transaction, advanced)
…ddleware, queues, request, server, services, sessions, testing, tracing, websockets)
…(docker, fly, heroku, digital-ocean, nginx, supervisor, systemd, contributing, legacy-docs)
@Rychillie
Rychillie force-pushed the Rychillie/vapor-docs-pt-br branch from c671e42 to 9e29f74 Compare April 5, 2026 18:17
… strings, and placeholders across all 47 files
…s-pt-br

# Conflicts:
#	docs/4.0/advanced/apns.pt.md
#	docs/4.0/advanced/commands.pt.md
#	docs/4.0/advanced/files.pt.md
#	docs/4.0/advanced/middleware.pt.md
#	docs/4.0/advanced/queues.pt.md
#	docs/4.0/advanced/request.pt.md
#	docs/4.0/advanced/server.pt.md
#	docs/4.0/advanced/services.pt.md
#	docs/4.0/advanced/sessions.pt.md
#	docs/4.0/advanced/testing.pt.md
#	docs/4.0/advanced/tracing.pt.md
#	docs/4.0/advanced/websockets.pt.md
#	docs/4.0/basics/async.pt.md
#	docs/4.0/basics/client.pt.md
#	docs/4.0/basics/content.pt.md
#	docs/4.0/basics/controllers.pt.md
#	docs/4.0/basics/environment.pt.md
#	docs/4.0/basics/errors.pt.md
#	docs/4.0/basics/logging.pt.md
#	docs/4.0/basics/routing.pt.md
#	docs/4.0/basics/validation.pt.md
#	docs/4.0/contributing/contributing.pt.md
#	docs/4.0/deploy/digital-ocean.pt.md
#	docs/4.0/deploy/docker.pt.md
#	docs/4.0/deploy/fly.pt.md
#	docs/4.0/deploy/heroku.pt.md
#	docs/4.0/deploy/nginx.pt.md
#	docs/4.0/deploy/supervisor.pt.md
#	docs/4.0/deploy/systemd.pt.md
#	docs/4.0/fluent/advanced.pt.md
#	docs/4.0/fluent/migration.pt.md
#	docs/4.0/fluent/model.pt.md
#	docs/4.0/fluent/overview.pt.md
#	docs/4.0/fluent/query.pt.md
#	docs/4.0/fluent/relations.pt.md
#	docs/4.0/fluent/schema.pt.md
#	docs/4.0/fluent/transaction.pt.md
#	docs/4.0/getting-started/folder-structure.pt.md
#	docs/4.0/getting-started/hello-world.pt.md
#	docs/4.0/getting-started/spm.pt.md
#	docs/4.0/getting-started/xcode.pt.md
#	docs/4.0/install/linux.pt.md
#	docs/4.0/install/macos.pt.md
#	docs/4.0/leaf/custom-tags.pt.md
#	docs/4.0/leaf/getting-started.pt.md
#	docs/4.0/leaf/overview.pt.md
#	docs/4.0/redis/overview.pt.md
#	docs/4.0/redis/sessions.pt.md
#	docs/4.0/security/authentication.pt.md
#	docs/4.0/security/crypto.pt.md
#	docs/4.0/security/jwt.pt.md
#	docs/4.0/security/passwords.pt.md
#	mkdocs.yml
@0xTim

0xTim commented Jul 9, 2026

Copy link
Copy Markdown
Member

Oi @Rychillie - esta pronto? Quero fazer o merge disso em breve para não ficar muito desatualizado. Vc pode adicionar as traduções em novos PRs se as atuais ja estiverem prontas. Obrigado!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

translation-update This PR contains translations for the docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants